 Help v1.09       SideFile's SF.HLP       (DO NOT CHANGE THIS FILE STRUCTURE!) 
-------------------------------------------------------------------------------
Every line in this file must be exactly 79 characters long plus a carriage     
  return line feed for a total of 81 characters per line.  Take care NOT to    
  save this file from SideFile as the line lengths will be cut at the last     
  character on a line (spaces are stripped).  This will CORRUPT help the file. 
-------------------------------------------------------------------------------
Tinkerers may carefully load the file into another editor such as WordStar non-
  doc as long as they can be certain that each line stays at the proper length 
  for SideFile's random-access retrieval of the file.                          
Also, the numbers on some lines (such as 25, 50, 75, etc.) are a reminder of   
  what line SideFile expects a section to start.  The first section starts at  
  line number 25.  SideFile does not read these numbers.  They are there to    
  help the programmers, so don't add extra lines.  And don't make sections     
  longer than they are, because the extra lines will not be read!              
BONUS - With the menu off and while looking at a no-header file (such as this  
  one), press the Alt minus key (top of keyboard) and the message 'CAUTION: No-
  header Fill ON' should be displayed at the top.  This switch should not be   
  used by novices.  SideFile will now fill any no-header file with spaces to 79
  characters, allowing you to edit the file.  Also, this switch is an excellent
  way to fix a corrupted file due to improper line lengths from another editor.
-------------------------------------------------------------------------------
                                                                               
                                                                               
25                                                                             
GENERAL HELP  (Command help : highlight its menu, press <F1>)                  
───────────────────────────────────────────────────────────────────────────    
To access the menu, press an ^(Ctrl)-key like ^F for File commands, or just    
press the / key.  Commands issued with ^keys only, such as ^R ^I for RECORD    
Insert, will go away when finished.  Else the menu is 'sticky' (will return    
afterwards).                                                                   
───────────────────────────────────────────────────────────────────────────    
When a command is highlighted, press the <F1> key to learn more about it.      
Any command not allowed in the current operating mode or with the current      
file type will say ' (n/a)'.                                                   
───────────────────────────────────────────────────────────────────────────    
Pressing <esc> or / to leave the menu allows the / key to later restore it     
exactly where you left it.  Press a key to leave this command...               
┌─────────────────────────────────────────────────────────────────────────┐    
│FUNCTION KEYS  (Will call these commands when menu system not active)    │    
│              Normal                                Ælternate            │    
│F1-HELP General  F2-FILE Save        ÆF1-FILE DOS       ÆF2-FILE Load    │    
│F3-RECORD Insert F4-RECORD Delete    ÆF3-RECORD Append  ÆF4-RECORD Undo  │    
│F5-COLUMN Sort   F6-RECORD Show      ÆF5-COLUMN Width   ÆF6-VIEW List    │    
│F7-SEARCH Find   F8-SEARCH Replace   ÆF7-SEARCH Next    ÆF8-SEARCH Cont. │    
│F9-RECORD Goto   F0-COLUMN Total     ÆF9-RECORD Last    ÆF0-FILE Quit    │    
└─────────────────────────────────────────────────────────────────────────┘    
                                                                               
                                                                               
50                                                                             
NAVIGATING HELP                                                                
These keys allow movement around                                               
the screen and throughout the file.                                            
───────────────────────────────────                                            
 STab - go left one column                                                     
 Tab  - go right one column                                                    
^Home - goto far left column                                                   
^End  - goto far right column                                                  
 Up   - go up one row                                                          
 Down - go down one row                                                        
 PgUp - go up one page                                                         
 PgDn - go down one page                                                       
^PgUp - goto beginning of file                                                 
^PgDn - goto end of file                                                       
^W    - scroll up one row                                                      
^Z    - scroll down one row                                                    
^Q    - Go Home (top/left block)                                               
^E    - Erase screen and redraw                                                
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
75                                                                             
EDITING HELP                                                                   
These keys allow for editing data                                              
when in a highlighted edit block.                                              
───────────────────────────────────                                            
 Home  - goto beginning of line                                                
 End   - goto end of line                                                      
^Left  - goto previous word                                                    
^Right - goto next word                                                        
 Left  - go left one character                                                 
 Right - go right one character                                                
 Del   - delete character at cursor                                            
 BSp   - delete character at left                                              
^D     - delete to end of line                                                 
 Ins   - toggle Ins mode on/off                                                
 Enter - accept changes                                                        
 Esc   - cancel changes                                                        
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
100                                                                            
HEADERS HELP                                                                   
ASCII files readable by SideFile are either header                             
files or no-header files.                                                      
──────────────────────────────────────────────────────                         
Header files - contain a standard SF format header as                          
explained in the documentation.  This header tells SF                          
the type field, it's length, and the total record                              
length.  All commands are available for this normal                            
SideFile file.                                                                 
──────────────────────────────────────────────────────                         
No-header files - contain no header.  An example would                         
be your AUTOEXEC.BAT file or CONFIG.SYS file on your                           
boot diskette.  Many commands are not available with                           
this type file (mainly column oriented commands), and                          
SF reads these files as a matter of convenience for                            
you.  No-header files must contain no lines longer                             
than 79 characters.                                                            
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
125                                                                            
FIELDS HELP                                                                    
SideFile allows three types of data fields, character,                         
date, and number.                                                              
───────────────────────────────────────────────────────                        
Character fields - standard everyday fields containing                         
letters and numbers combined.  Max length is 65.                               
───────────────────────────────────────────────────────                        
Date fields - for dates of type YY-MM-DD or DD-MM-YY.                          
A period (.) can be defined instead of the dash (-).                           
These fields must be exactly 9 in length, and are                              
identified by a @ in the header.                                               
───────────────────────────────────────────────────────                        
Number fields - for numbers only, always displayed with                        
two decimal places.  These fields must be exactly 11 in                        
length, and are identified by a # in the header.                               
───────────────────────────────────────────────────────                        
Sample header (first line in SF formatted file):                               
Character          |Date   @|Number   #|                                       
Mastercard payment  87-04-30     300.56                                        
───────────────────────────────────────────────────────                        
Keep in mind that SF files are always in pure ASCII.                           
                                                                               
                                                                               
                                                                               
150                                                                            
MODES HELP                                                                     
SideFile operates in either MEMORY or DISK modes.                              
──────────────────────────────────────────────────────                         
MEMORY-based - all data is loaded and kept in memory                           
while using the file.  This makes for quick, easy                              
access and manipulation of data.  You must save this                           
type of file prior to quitting SF, or you will lose all                        
changes.  The only limiting factor with MEMORY files is                        
memory.  SF allocates around 45000 bytes for MEMORY                            
files, more than enough for most needs.  Up to 1000                            
records allowed depending on record length.                                    
───────────────────────────────────────────────────────                        
DISK-based - random-access mode whereby the file is                            
kept on disk and only active records are pulled into                           
memory as needed.  This data manager conventional mode                         
is not as quick or easy.  It is certainly less for-                            
giving as changes are immediately written to disk.                             
However it quells the one limit of the MEMORY mode -                           
size of the file - with a limit of 30000 records.  Most                        
column-oriented commands are not available.                                    
                                                                               
                                                                               
                                                                               
                                                                               
175                                                                            
REPORTING HELP                                                                 
These Kut and Axis parameters determine                                        
report formats sent to the printer,                                            
screen, and disk.                                                              
Kut/Axis                                                                       
 v  v                                                                          
───────────────────────────────────────                                        
DATA FILES                                                                     
On /X - one line only per record                                               
On /Y - one line per field (use arrows)                                        
On /Z - records in 'raw' format                                                
Off/X - one plus lines per record                                              
Off/Y - one line per field                                                     
Off/Z - records in 'raw' format                                                
───────────────────────────────────────                                        
TEXT FILES                                                                     
---/- - all choices are in 'raw' format                                        
───────────────────────────────────────                                        
Field totals reported in X and Y axis                                          
modes for found records only.                                                  
                                                                               
                                                                               
                                                                               
                                                                               
200                                                                            
DEFAULTS HELP  (Set these default switches prior to entering SideFile)         
The following switches may be put in DOS environment or entered on the         
command line to change SF defaults.  (Check documentation for more.)           
Command line switches take precedence over environment settings.               
Command line requires a /.  n=single digit number (?)=original default         
────────────────────────────────────────────────────────────────────────       
Environment: SET SIDEFILE=ABC  -or-  Command line: SF DATAFILE /A/B/C          
An   Axis type (0=X) 1=Y 2=Z         N    Normal date display on (off)         
Bnn  Bottom print margin 10-99 (54)  O    backward date display on (on)        
D    Disk-based filing on (off)      Rn   Reverse color 1-7 (m=7 c=3)          
F    Fast screen write on (off)      S    Sort file backup file off (on)       
Hnn  High color 09-15 (m=15 c=14)    Tn   Top print margin 1-9 (1)             
I    date spacer . (-)               U    Unkut view mode on (off)             
J    date spacer - (-)               V    Version only (testing only)          
K    Kut screen columns on (off)     W    Wait for print paper on (off)        
Ln   Low color 1-7 (m=7 c=6)         Z    tandy 1000 bios fix on (off)         
M    Memory-based filing on (on)     SET SFHELP=D:\DIR                         
Pn   Print rules (0=internal) 1=Epson internal 2=external file SF.PRT          
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
225                                                                            
SIDETRAN HELP  (May be run from within SideFile with DOS command)              
In addition to SF's normal ASCII file format which will translate              
to almost any program (including dBASE II SDF format and 1-2-3's               
PRN format), SideTran, SF's conversion utility, will translate SF              
files to and from dBASE II's file format and ASCII delimited-type              
file formats (also usable by most programs).                                   
───────────────────────────────────────────────────────────────────            
dBASE II - ST translates character, number, and logical field types            
to and from dBASE II to SF.  Logical fields are not used by SF but             
ST will ask if you wish one-length fields to be logical fields when            
converting to dBASE II.  Number fields are respected, but should be            
11 or less in the dBASE II format.  SF date fields are not used by             
dBASE II, but ST asks about any nine-length fields when converting             
back to SF.  Field names are converted (spaces are filled with :).             
Keep SF's limits in mind when translating from dBASE II (1000 or               
30000 records, min 2 - 16 fields, max field length 65, max record              
length 250, 2 or more fields, etc.).                                           
───────────────────────────────────────────────────────────────────            
ASCII DELIMITED - similar to ASCII transfer, except that field                 
lengths are remembered in the convertsion.  Simply define header               
data when converting to SF (headers are not kept).  ST defaults to             
the extension [.TXT].          Example: 'John','Doe',5000.00,'Paid'            
                                                                               
                                                                               
250                                                                            
FILING SCREEN HELP  (More help available after loading/creating a file)        
Highlight file with <Up/Down/PgUp/PgDn>, or enter filename in edit block.      
To view part of dir, enter dir spec [*.SF], which must contain a [*].  Do      
not enter drives [A:] or dirs [\WORK] in dir spec.  Use <F3/F4> to change      
drives/dirs, and <F2> to change to initial drive/dir.  Max files shown is      
100.  Files may be read/written to current drive/dir only (except SAVEing      
where they are always written to their home drive/dir).                        
─────────────────────────────────────────────────────────────────────────      
Don't pick programs ending in [.COM], [.EXE], [.DBF], etc, unless in DOS.      
Pick MEMORY for smaller, faster filing or DISK for larger, slower filing.      
Use SideTran to convert dBase II [.DBF] and ASCII delimited [.TXT] files.      
┌───────────────────────────────────────────────────────────────────────┐      
│FUNCTION KEYS                                                          │      
│ÆF1-DOS                                                                │      
│ F1-Help                         F2-Change to initial startup drive/dir│      
│ F3-Change to new drive          F4-Change to new dir (subdirectory)   │      
│ F5-View first part of file      F6-Run [.COM], [.EXE], or [.BAT] file │      
│ F7-Rename file                  F8-Delete file                        │      
│ F9-Pick MEMORY or DISK filing                                         │      
│                                ÆF0-Quit SideFile program (end session)│      
└───────────────────────────────────────────────────────────────────────┘      
                                                                               
                                                                               
                                                                               
275 menu1                                                                      
HELP MENU HELP                                                                 
General    - About how to use the pop-up menu, etc.                            
Navigating - About moving around the file.                                     
Editing    - About editing the data.                                           
Headers    - About header/non-header file types.                               
Fields     - About character/date/number data fields.                          
Modes      - About MEMORY/DISK modes.                                          
Reporting  - About view parameter affects on reports.                          
Defaults   - About SideFile default switches.                                  
SideTran   - About additional import/export procedures                         
             available with with SideTran, SideFile's                          
             on-disk conversion utility.                                       
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
300 menu2                                                                      
FILE MENU HELP                                                                 
Load    - Load new or existing SF file from disk.  Current file is dis-        
          carded if in MEMORY mode.  DISK mode files are always current.       
Save    - (MEMORY only) Save current file to disk and continue operation.      
          DISK mode files are always up-to-date.                               
Squeeze - (DISK only) Remove all blank records from current file.  Acts like   
          a file packer.                                                       
Write   - Save current file to disk as another SF format file with new name.   
          Can save all or part of file (by record numbers or find criteria).   
Read    - Read SF format file from disk, appending it to current file.  Can    
          rejoin smaller files to one large file while in DISK mode.           
Print   - Print current file to printer in current view format.  Can print     
          all or part of file (by record numbers or find criteria).            
Image   - Print current file to disk in current view format (like printing).   
          Can include all or part of file (by record numbers or with find).    
View    - View first few lines of disk file.  Should not attempt to view       
          program-type non-ASCII files like .COM and .EXE, etc.                
Type    - Display structure of current file.                                   
DOS     - Go temporarily to the system to run DOS commands and/or other        
          programs (memory permitting).  COMMAND.COM must be found.            
Quit    - Quit SideFile program to DOS permanently.  End of session.           
          If in MEMORY mode, save current file first.                          
                                                                               
                                                                               
325 menu3                                                                      
RECORD MENU HELP                                                               
Insert - Insert blank record just before current record.  In DISK mode         
         RECORD Append may be more desirable due to excessive disk access.     
Delete - Delete current record (NOT undo-able in DISK mode).  RECORD Blank     
         (DISK only) may be more desirable due to excessive disk access.       
Append - Insert blank record at end of file.  Consider VIEW Append for         
         appending multiple records.                                           
Undo   - (MEMORY only) Insert last deleted record just before current          
         record.  Becomes RECORD Blank in DISK mode (not undoable).            
Blank  - (DISK only) Blank record at cursor position.  Can later FILE          
         Squeeze file.  Becomes RECORD Undo in MEMORY mode.                    
Show   - (headers only) Display entire current record in view temporarily.     
         For those files with records longer than screen length.               
Goto   - Goto specified record number.  Can later use RECORD Last to go        
         back to current record.                                               
Last   - Goto previous record number.  Can use after a RECORD Goto command     
         to jump back and forth between two sections of the file.              
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
350 menu4                                                                      
COLUMN MENU HELP                                                               
Insert - (MEMORY with headers only) Insert blank column just before current    
         column.  Enter @ or # as length for date or number columns.           
Delete - (MEMORY with headers only) Delete current column.  Will be kept in    
         column buffer if memory permits.  Later use COLUMN Undo.              
Append - (MEMORY with headers only) Insert blank column at end of file.        
         Enter @ or # as length for date or number columns.                    
Undo   - (MEMORY with headers only) Insert last deleted column.                
Sort   - Sort records on current cursor position.  In DISK mode a longer       
         DISK sort will be performed, followed by a FILE Squeeze.              
Width  - (MEMORY with headers only) Change current column width.  WARNING!     
         Clipped data is NOT recoverable.  Character columns only.             
Name   - (headers only) Change current column name.  Can not use with          
         columns having thickness of only one character.                       
Order  - (MEMORY with headers only) Insert a temporary 'order' column to       
         preserve current order before new sort.  Good for <1000 records.      
Case   - Change current column to upper/lower case.  Entire column will be     
         affected.  Character columns only.                                    
Redate - Reverse date format, Switch date edit block default, or Change        
         date spacer.  Must be pointing at a Date column.                      
Total  - (headers only) Total current column.  Multi-column total is           
         displayed with (=).  Number columns only.                             
Kut    - (headers only) Toggle display of columns to multiple or single.       
                                                                               
375 menu5                                                                      
SEARCH MENU HELP                                                               
Find     - Find non-case-sensitive text starting at current                    
           record.  VIEW Find also available.                                  
Next     - Find next occurence of non-case-sensitive text.                     
Absolute - Find case-sensitive text starting at current record.                
Replace  - Replace case-sensitive text starting at current                     
           record.  VIEW Replace also available.                               
Continue - Replace next occurence of case-sensitive text.                      
Global   - Replace case-sensitive text from current record to                  
           end of file.                                                        
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
400 menu6                                                                      
VIEW MENU HELP                                                                 
List    - List records depending on current view format.  See HELP for         
          more on how view switches affect print/screen/disk reporting.        
Find    - Find non-case-sensitive text in current view format for all          
          records.  SEARCH Find also available.                                
Replace - Replace case-sensitive text in current view format for all           
          records. SEARCH Replace also available.                              
Append  - (headers only) Insert multiple records and associated data at        
          end of file.                                                         
X-axis  - Turn VIEW X-axis mode on (each record lists from left to right).     
Y-axis  - Turn VIEW Y-axis mode on (each record lists from top to bottom).     
Z-axis  - Turn VIEW Z-axis mode on (each record lists exactly as on disk).     
Kut     - Turn VIEW Kut mode on/off (each record lists/may not list one        
          per line).                                                           
Status  - Status of VIEW ?-axis and VIEW Kut switches.  See HELP for more      
          on how these switches affect print/screen/disk reporting.            
                                                                               
